Move documentation to inline comments: GtkVScrollbar

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=611658

diff --git a/docs/reference/gtk/tmpl/gtkvscrollbar.sgml b/docs/reference/gtk/tmpl/gtkvscrollbar.sgml
deleted file mode 100644 (file)
index 84efad5..0000000
--- a/docs/reference/gtk/tmpl/gtkvscrollbar.sgml
+++ /dev/null
@@ -1,40 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkVScrollbar
-
-<!-- ##### SECTION Short_Description ##### -->
-A vertical scrollbar
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-The #GtkVScrollbar widget is a widget arranged vertically creating a
-scrollbar. See #GtkScrollbar for details on
-scrollbars. #GtkAdjustment pointers may be added to handle the
-adjustment of the scrollbar or it may be left %NULL in which case one
-will be created for you. See #GtkScrollbar for a description of what the
-fields in an adjustment represent for a scrollbar.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-#GtkScrollbar, #GtkScrolledWindow
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GtkVScrollbar ##### -->
-<para>
-The #GtkVScrollbar struct contains private data and should be accessed
-using the functions below.
-</para>
-
-
-<!-- ##### FUNCTION gtk_vscrollbar_new ##### -->
-<para>
-
-</para>
-
-@adjustment: 
-@Returns: 
-
-

diff --git a/gtk/gtkvscrollbar.c b/gtk/gtkvscrollbar.c
index 3287e09263f06212baf81d859220e24a9022a6d0..8e87c885eec652f7cab174c33d79b13e7d3b7878 100644 (file)
--- a/gtk/gtkvscrollbar.c
+++ b/gtk/gtkvscrollbar.c
@@ -32,6 +32,20 @@
 #include "gtkintl.h"
 #include "gtkalias.h"
 
+/**
+ * SECTION:gtkvscrollbar
+ * @Short_description: A vertical scrollbar
+ * @Title: GtkVScrollbar
+ * @See_also:#GtkScrollbar, #GtkScrolledWindow
+ *
+ * The #GtkVScrollbar widget is a widget arranged vertically creating a
+ * scrollbar. See #GtkScrollbar for details on
+ * scrollbars. #GtkAdjustment pointers may be added to handle the
+ * adjustment of the scrollbar or it may be left %NULL in which case one
+ * will be created for you. See #GtkScrollbar for a description of what the
+ * fields in an adjustment represent for a scrollbar.
+ */
+
 G_DEFINE_TYPE (GtkVScrollbar, gtk_vscrollbar, GTK_TYPE_SCROLLBAR)
 
 static void

diff --git a/gtk/gtkvscrollbar.h b/gtk/gtkvscrollbar.h
index 2a8e85e8a0fb1a9d439c54152a63287bff4494ed..2cd2ec971c2607b62c0fd31af1bdc45d72a7f25c 100644 (file)
--- a/gtk/gtkvscrollbar.h
+++ b/gtk/gtkvscrollbar.h
@@ -49,6 +49,12 @@ G_BEGIN_DECLS
 typedef struct _GtkVScrollbar       GtkVScrollbar;
 typedef struct _GtkVScrollbarClass  GtkVScrollbarClass;
 
+/**
+ * GtkVScrollbar:
+ *
+ * The #GtkVScrollbar struct contains private data and should be accessed
+ * using the functions below.
+ */
 struct _GtkVScrollbar
 {
   GtkScrollbar scrollbar;